home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / os2 / bos2_xr2.zip / XE_USER.DOC < prev   
Text File  |  1996-06-13  |  40KB  |  907 lines
  1. User documentation for modified Binkley 2.60 XE
  2. ===============================================
  3.  
  4. Binkley 2.60 original version is (c) Vince Perriello and available
  5. at 2:2474/400. Filenames: B???_260.ZIP (??? = DOS, OS2, W32 or SRC).
  6.  
  7. Modifications were done by (in alphabetical order) :
  8.   Carsten Ellermann,  2:2432/215
  9.   Tobias Ernst,       2:2476/418
  10.   Rudolf Heeb,        2:2464/44
  11.   Martin M. Pedersen, 2:238/45
  12.   Matthias Tichy,     2:2433/955
  13.   Thomas J. Waldmann, 2:2474/400
  14.  
  15. This BT-XE version is named BT 2.60XE9606132330
  16. This is date and time of creation    ^----^^--^  of this compiled version.
  17. Please refer to this version string if you speak of this modified version.
  18. To be short, we abbreviate this as BT-XE below...
  19.  
  20. Standard disclaimer: regard this as BETA software.
  21.  
  22. Although we don't know "known bugs" built in by us at the time of this beta
  23. release, we can NOT guarantee. So use it on your own risk ...
  24.  
  25. If you have any problem with this BT-XE version, please contact us!
  26.  
  27. Also, if you are a programmer and doing BT source code modifications /
  28. enhancements / bugfixes, too, please also contacts us and work together with
  29. us on this great project!
  30.  
  31. Tip from Hauke Hagenhoff, 2:2453/1030
  32. =====================================
  33.  
  34. COM.SYS:
  35.  
  36. When using the original serial-port-driver for OS/2, COM.SYS, you will need to 
  37. configure the port using the MODE command for having BinkleyTerm work all right.
  38.  
  39. The following setting is recommended:
  40.  
  41. MODE COMx:yyyyy,N,8,1,,TO=ON,XON=OFF,IDSR=OFF,ODSR=OFF,OCTS=ON,
  42.      DTR=HS,RTS=HS,BUFFER=ON
  43. (you need to enter this as ONE line!)
  44.  
  45. where x is the COMx:-port to set and yyyyy the desired port speed.
  46. Most important are the IDSR and ODSR-settings, if they are wrong, BT won't work  
  47. properly. BUFFER=ON is to switch the FIFO-buffer on.
  48.  
  49.  
  50. Modifications in this version done by Carsten Ellermann:
  51. ========================================================
  52.  
  53. - Max. number of AKAs raised from original 25 to BT-XE value of 100 AKAs.
  54.  
  55. - "ConditionalPoll" - this new function is inserted in BinkleyTerm.
  56.   New: Multi-AKA and boolean operation support implemented by Thomas Waldmann.
  57.   ConditionalPoll (also known as "FreePoll" from Arjen G. Lentz, who invented
  58.   this in his mailer XENIA) allows an Uplink (you) to reject a call from a
  59.   Downlink, if there is less mail for him than the configured minimum.
  60.   This function will only work with ISDN or a modem that reports the caller ID
  61.   in the "Ring" string.
  62.   It's possible to list up to 100 ConditionalPoll entries.
  63.  
  64.   How it does work: the downlink will call you, Binkley gets the caller-ID
  65.   (eg. "RING 57313340"), searches ALL ConditionalPoll entries for matching
  66.   addresses and checks if the condition (minimum outbound size for this AKA)
  67.   says "reject call" or "accept call" for each AKA.
  68.   The exact condition is: if outbound size <= MinSize * 1024 then reject.
  69.   MinSize = 0 rejects a call only if there is really NOTHING (0 bytes) on hold.
  70.   
  71.   Each result (accept=TRUE or accept=FALSE) is evaluated (together with the
  72.   result of previous calculation for this number) with the according
  73.   boolean operation "AND" or "OR" to calculate the total result.
  74.  
  75.   The boolean operation listed with the first configured ConditionalPoll entry
  76.   matching a specific number does not care, you can use "Or" or "And" - it
  77.   makes no difference.
  78.   If total result is TRUE, call will be accepted.
  79.   If total result is FALSE, call will be rejected.
  80.   To reject a call Binkley sends the string configured with "Reject" to the
  81.   modem. To accept a call, Binkley sends the answer string (normal behaviour).
  82.  
  83.   For downlinks who want to make a file request or send an important crash
  84.   mail immediately, Binkley builds a zero byte size file in the outbound
  85.   called "*.TRX" for each user. If the downlink gets a "call reject", he/she
  86.   can call again within MaxDeltaT seconds and the call will be handled normally.
  87.  
  88.   To configure the function use:
  89.  
  90.   ; accept call of 07142980031 if size for 2:2474/405>=100KB or 2nd call
  91.   ; within 30 seconds:
  92.   ;ConditionalPoll  Or/And AKA [3..5D]  MinSize[KB]  MaxDeltaT[s] Phone
  93.   ConditionalPoll   Or     2:2474/405   100          30           07142980031
  94.  
  95.   ; accept call of 07142980032 if (size for 2:2474/403>=20KB or 2nd call within
  96.   ; 30 seconds) *AND* (size for 21:492/4003 >= 10KB or 2nd call within 20s).
  97.   ;ConditionalPoll  Or/And AKA [3..5D]  MinSize[KB]  MaxDeltaT[s] Phone
  98.   ConditionalPoll   Or     2:2474/403    20          30           07142980032
  99.   ConditionalPoll   And    21:492/4003   10          20           07142980032
  100.  
  101.   ; accept call of 07142980032 if (size for 2:2474/403>=100KB or 2nd call within
  102.   ; 30 seconds) *OR* (size for 21:492/4003 >= 50KB or 2nd call within 20s).
  103.   ;ConditionalPoll  Or/And AKA [3..5D]  MinSize[KB]  MaxDeltaT[s] Phone
  104.   ConditionalPoll   Or     2:2474/403   100          30           07142980032
  105.   ConditionalPoll   Or     21:492/4003   50          20           07142980032
  106.  
  107.   ; you may configure up to 100 such ConditionalPoll lines
  108.   ; dependant on your ISDN adaptor and configuration, you maybe should
  109.   ; leave out the leading "0" (national calls) or "00" (intl calls).
  110.  
  111.   To reject a call, define once:
  112.  
  113.         Reject <Modem command string|>
  114.  
  115.   For a ZyXEL Elite 2864I use:
  116.  
  117.         Reject ATH1|ATH0|
  118.  
  119.   For ELINK 310 use:
  120.         Reject AT\\K|
  121.         ATS21.2=1     (shows caller number after RING - tested with EPROM 1.36)
  122.  
  123.   For ELINK 301 use:
  124.  
  125.         Reject AT\\K|     (since EPROM version 2.20 of 11.5.94)
  126.         AT\O5            (show caller number after RING, since v2.12)
  127.  
  128.   Restriction for ELINKs: until a ROM is released which supports a "Call
  129.   rejected" response code, you will only be able to reject incoming calls, but
  130.   not to treat being rejected yourself (you will just receive "NO CARRIER" if
  131.   you are rejected). You may configure a very LOW MaxDeltaT value to handle
  132.   this (not nice, but possible) - see also binkley event file A= parameter.
  133.   But your links should be aware that they will flag you undialable if they
  134.   dial too often without getting a connection.
  135.  
  136. - New CFG-verb "ModemReject" to identify a rejection response from the modem.
  137.   New CFG-verb "AfterCallOut" to send an AT???-command to get a cause value
  138.   from ISDN adapters like ZyXEL 2864I.
  139.  
  140.   There are two different ways to see if a call is rejected:
  141.   1) The ISDN adapter sends "Busy/Cause=34Be" in one line.
  142.   2) You send an AT??? command and get an answer like "Cause = Call reject".
  143.  
  144.   For 1) you need only "ModemReject <Rejectstring>", for 2) you need the
  145.   Rejectstring and "AfterCallOut <Lines> <AT command>".
  146.  
  147.   AfterCallOut needs a number of lines (of output caused by AT command) and an
  148.   AT command which leads to a report with the cause value.
  149.  
  150.   After a rejected outbound call, all mail to this AKA will change to NORMAL
  151.   flavour. Now you have an easy way to ping your Uplink, if he knows the
  152.   feature of Freepoll<tm>/ConditionalPoll.
  153.   ModemReject will only work with automatic call not with manual calls!
  154.  
  155.   For ZyXEL 2864I i use "AfterCallOut 9 ATI3|" and "ModemReject Call reject".
  156.   For CFOS you need only "ModemReject /Cause=34Be".
  157.   For ELINK, there is no such possibility until now.
  158.  
  159. - "ChangeMailTo <flavor>" for changing mail flavor to CRASH, DIRECT, NORMAL
  160.   or HOLD after an rejected outbound call. The default is the change to
  161.   Normal flavor.
  162.  
  163.  
  164. Modifications in this version done by Tobias Ernst:
  165. ===================================================
  166.  
  167. - Support  for a PROBOARD fileindex.  Rather than scanning  your whole hard
  168.   disk for each file request, information can now be  taken  directly  from
  169.   your  Proboard  configuration, so that a) you don't have to set up a huge
  170.   OKFile and b)  file  request  is  accelerated  considerably, allowing for
  171.   filerequest from CDROM.  Perform the following steps to set  up  Proboard
  172.   support (this works much like the configuration of a Maximus fileindex):
  173.  
  174.   - Add the following lines to your Binkley.Cfg
  175.  
  176.        PBAreas <Proboard Fileareaconfig>
  177.  
  178.